home *** CD-ROM | disk | FTP | other *** search
/ Java Programmer's Toolkit / Java Programmer's Toolkit.iso / include / sys_api.h < prev    next >
C/C++ Source or Header  |  1996-01-12  |  4KB  |  146 lines
  1. /*
  2.  * @(#)sys_api.h    1.41 95/11/29
  3.  *
  4.  * Copyright (c) 1994 Sun Microsystems, Inc. All Rights Reserved.
  5.  *
  6.  * Permission to use, copy, modify, and distribute this software
  7.  * and its documentation for NON-COMMERCIAL purposes and without
  8.  * fee is hereby granted provided that this copyright notice
  9.  * appears in all copies. Please refer to the file "copyright.html"
  10.  * for further important copyright and licensing information.
  11.  *
  12.  * SUN MAKES NO REPRESENTATIONS OR WARRANTIES ABOUT THE SUITABILITY OF
  13.  * THE SOFTWARE, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
  14.  * TO THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
  15.  * PARTICULAR PURPOSE, OR NON-INFRINGEMENT. SUN SHALL NOT BE LIABLE FOR
  16.  * ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING OR
  17.  * DISTRIBUTING THIS SOFTWARE OR ITS DERIVATIVES.
  18.  */
  19.  
  20. /*
  21.  * System or Host dependent API.  This defines the "porting layer" for
  22.  * POSIX.1 compliant operating systems.
  23.  */
  24.  
  25. #ifndef _SYS_API_H_
  26. #define _SYS_API_H_
  27.  
  28. /*
  29.  * typedefs_md.h includes basic types for this platform;
  30.  * any macros for HPI functions have been moved to "sysmacros_md.h"
  31.  */
  32. #include "typedefs_md.h"
  33.  
  34. /*
  35.  * Miscellaneous system utility APIs that fall outside the POSIX.1
  36.  * spec.
  37.  *
  38.  * Until POSIX (P1003.1a) formerly P.4 is standard, we'll use our
  39.  * time struct definitions found in timeval.h.
  40.  */
  41. #include "timeval.h"
  42. long     sysGetMilliTicks(void);
  43. long    sysTime(long *);
  44. int64_t sysTimeMillis(void);
  45.  
  46. #include "time.h"
  47. struct tm * sysLocaltime(time_t *, struct tm*);
  48. struct tm * sysGmtime(time_t *, struct tm*);
  49. void        sysStrftime(char *, int, char *, struct tm *);
  50. time_t      sysMktime(struct tm*);
  51.  
  52.  
  53. /*
  54.  * System API for general allocations
  55.  */
  56. void *    sysMalloc(size_t);
  57. void *    sysRealloc(void*, size_t);
  58. void    sysFree(void*);
  59. void *    sysCalloc(unsigned int, unsigned int);
  60.  
  61. /*
  62.  * System API for dynamic linking libraries into the interpreter
  63.  */
  64. char *  sysInitializeLinker(void);
  65. int     sysAddDLSegment(char *);
  66. void    sysSaveLDPath(char *);
  67. long    sysDynamicLink(char *);
  68. void    sysBuildLibName(char *, int, char *, char *);
  69.  
  70. /*
  71.  * System API for threads
  72.  */
  73. typedef struct  sys_thread sys_thread_t;
  74. typedef struct  sys_mon sys_mon_t;
  75. typedef void *  stackp_t;
  76.  
  77. int     sysThreadBootstrap(sys_thread_t **);
  78. void     sysThreadInitializeSystemThreads(void);
  79. int     sysThreadCreate(long, uint_t flags, void *(*)(void *),
  80.             sys_thread_t **, void *);
  81. void    sysThreadExit(void);
  82. sys_thread_t * sysThreadSelf(void);
  83. void    sysThreadYield(void);
  84. int    sysThreadSuspend(sys_thread_t *);
  85. int    sysThreadResume(sys_thread_t *);
  86. int    sysThreadSetPriority(sys_thread_t *, int);
  87. int    sysThreadGetPriority(sys_thread_t *, int *);
  88. void *  sysThreadStackPointer(sys_thread_t *); 
  89. stackp_t sysThreadStackBase(sys_thread_t *); 
  90. int    sysThreadSingle(void);
  91. void    sysThreadMulti(void);
  92. int     sysThreadEnumerateOver(int (*)(sys_thread_t *, void *), void *);
  93. void    sysThreadInit(sys_thread_t *, stackp_t);
  94. void    sysThreadSetBackPtr(sys_thread_t *, void *);
  95. void *  sysThreadGetBackPtr(sys_thread_t *);
  96. int     sysThreadCheckStack(void);
  97. int     sysInterruptsPending(void);
  98. void    sysThreadPostException(sys_thread_t *, void *);
  99. void    sysThreadDumpInfo(sys_thread_t *);
  100.  
  101. /*
  102.  * System API for monitors
  103.  */
  104. int     sysMonitorSizeof(void);
  105. int     sysMonitorInit(sys_mon_t *, bool_t);
  106. int     sysMonitorEnter(sys_mon_t *);
  107. bool_t  sysMonitorEntered(sys_mon_t *);
  108. int     sysMonitorExit(sys_mon_t *);
  109. int     sysMonitorNotify(sys_mon_t *);
  110. int     sysMonitorNotifyAll(sys_mon_t *);
  111. int     sysMonitorWait(sys_mon_t *, int);
  112. int    sysMonitorDestroy(sys_mon_t *, sys_thread_t *);
  113. void    sysMonitorDumpInfo(sys_mon_t *);
  114.  
  115. #define SYS_OK            0
  116. #define SYS_TIMEOUT     1
  117. #define SYS_ERR           -1
  118. #define SYS_INVALID    -2    /* invalid arguments */
  119. #define SYS_NOTHREAD   -3    /* no such thread */
  120. #define SYS_MINSTACK   -4    /* supplied stack size less than min stack size */
  121. #define SYS_NOMEM      -5
  122. #define SYS_NORESOURCE -6
  123. #define SYS_DESTROY    -7
  124.  
  125. /*
  126.  * System API for raw memory allocation
  127.  */
  128. void *  sysMapMem(long, long *);
  129. void *  sysUnmapMem(void *, long, long *);
  130. void *  sysCommitMem(void *, long, long *);
  131. void *  sysUncommitMem(void *, long, long *);
  132.  
  133. /*
  134.  * System API for termination
  135.  */
  136. void    sysExit(int);
  137. int    sysAtexit(void (*func)(void));
  138. void    sysAbort(void);
  139.  
  140. /*
  141.  * Include platform specific macros to override these
  142.  */
  143. #include "sysmacros_md.h"
  144.  
  145. #endif /* !_SYS_API_H_ */
  146.